home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cvtq10.zip / CVTQ10.TXT < prev    next >
Text File  |  1993-01-17  |  4KB  |  121 lines
  1.                      CvtQuote 1.0 Documentation
  2.  
  3.  
  4.                    R.G. Brickner, CIS:[76530,1456]
  5.  
  6.  
  7.       TITLE:  Convert Fractional Securities Quotes to Decimal
  8.  
  9.  
  10.       KEYWORDS:  CONVERT QUOTE FRACTION DECIMAL WINDOWS DOS FILTER
  11.  
  12.  
  13. ABSTRACT:
  14.  
  15. CvtQuote is a simple but sophisticated program to convert securities quotes
  16. from fractional form to decimal form.  The input is assumed to consist
  17. of a standard DOS text file, most probably a capture or log file from an
  18. information service session, which contains securities quotes in fractional
  19. form.  The output is a DOS text file with the fractional amounts converted
  20. to decimal amounts. CvtQuote is supplied as both a Windows 3.1 application
  21. and as a DOS command-line application.  Satisfied users are requested to
  22. remit a small fee.
  23.  
  24.  
  25. DESCRIPTION:
  26.  
  27. CvtQuote is a simple but sophisticated  program to convert securities quotes
  28. from fractional form to decimal form.  The input is assumed to consist
  29. of a standard DOS text file, most probably a capture or log file from a
  30. information service session, which contains lines of the form
  31.  
  32.    mm/dd/yy    i    i  i/i    i  i/i   i  i/i
  33.  
  34. where the date may or may not include leading zeroes, and i is an integer.
  35. (For example:  Date, Volume, High/Ask Low/Bid Close/Avg).  The fractional
  36. part of the amounts need not exist;  CvtQuote handles equally well quotes
  37. of the form
  38.  
  39.    mm/dd/yy    i    i  i/i    i        i  i/i
  40.  
  41. and so on.  The output is in the form
  42.  
  43.    mm/dd/yy    i      i.ii      i.ii     i.ii
  44.  
  45. where the decimal forms of the amounts are the correct conversions from
  46. the fractional forms.  Lines which do not contain quotes of this form
  47. are copied unchanged to the output.  Note the parser also recognizes
  48. some quotes of the above form with extra embedded characters, so
  49. occasional 'noise' will not prevent the parser from recognizing these
  50. lines.
  51.  
  52. Only global replacement of lines of the above form is currently
  53. supported.  Other functionality, such as conversion of selected text or
  54. find-and-replace, could be implemented if there is a demand.
  55.  
  56. Do not convert a file twice - the results will not be what you want!
  57.  
  58. Both DOS and Windows 3.1 versions of the program are provided.
  59.  
  60.  
  61. INSTALLATION AND USAGE - WINDOWS 3.1 VERSION:
  62.  
  63. CvtQuote has been developed for Windows 3.1.  To install, uncompress the
  64. distribution file, and copy the Windows executable file 'CVTQ_W.EXE'
  65. to a suitable directory.  Add the executable as a new program item in a
  66. suitable group, or choose 'File/Run' from the Program Manager and fill in
  67. the path of CVTQ_W.EXE.  CVTQ_W.EXE will take a file name as a
  68. command-line argument.
  69.  
  70. Once you have started CvtQuote, it behaves much like a simple text
  71. editor such as Notepad. The quote conversion capability is accessed by
  72. means of the 'Edit/Convert All Quotes' menu item.  Choosing this menu item
  73. will convert all lines from fractional to decimal form.
  74.  
  75. CVTQ_W.EXE, the Windows version of this program, has a rather limited
  76. text-file capacity.  If that capacity is exceeded for a given file, it
  77. cannot recover the memory.  You must restart CvtQuote.  Ample warning
  78. dialogs are provided.  The DOS version of CvtQuote does not have these
  79. memory limitations.  You may use it in a DOS window or full-screen DOS
  80. session to convert large files.
  81.  
  82.  
  83. INSTALLATION AND USAGE - DOS VERSION:
  84.  
  85. CvtQuote has been developed for DOS 5.0, but it should work with most
  86. earlier versions of DOS.  To install, uncompress the distribution file,
  87. and copy the DOS executable file 'CVTQ.EXE' to a suitable directory
  88. which is included in your execution path.  The DOS version of CvtQuote
  89. runs in two modes, as a filter and with file name arguments.
  90.  
  91. CvtQuote as a filter:
  92.  
  93.   CVTQ < INFILE.TXT > OUTFILE.TXT
  94.  
  95. CvtQuote with command-line arguments:
  96.  
  97.   CVTQ   INFILE.TXT   OUTFILE.TXT
  98.  
  99. Any other usage will give you a usage hint.
  100.  
  101.  
  102.  
  103. "LICENSE":
  104.  
  105. This software is provided mainly to see if anyone has a use for such
  106. things.  Your comments on the functionality and interface, and suggestions
  107. for extensions or improvements are actively sought.  Send EMAIL to
  108.  
  109.    CIS:[76530,1456]
  110.  
  111. However, if you find CvtQuote useful, it would be kind of you to make a
  112. small financial contribution:
  113.  
  114.    Send $5 to:
  115.  
  116.     R.G. Brickner
  117.     PO Box 9840
  118.     Santa Fe, NM 87504
  119.  
  120.                 CvtQuote is Copyright 1993 by R.G. Brickner
  121.